Skip to main content

md syntaxing

Headings

MarkdownHTMLRendered Output
# Heading level 1<h1>Heading level 1</h1># Heading level 1
## Heading level 2<h2>Heading level 2</h2>## Heading level 2
### Heading level 3<h3>Heading level 3</h3>### Heading level 3
#### Heading level 4<h4>Heading level 4</h4>#### Heading level 4
##### Heading level 5<h5>Heading level 5</h5>##### Heading level 5
###### Heading level 6<h6>Heading level 6</h6>###### Heading level 6
Heading level 1
===============
<h1>Heading level 1</h1># Heading level 1
Heading level 2
---------------
<h2>Heading level 2</h2>
## Heading level 2

Bold

To bold text, add two asterisks or underscores before and after a word or phrase. To bold the middle of a word for emphasis, add two asterisks without spaces around the letters.

MarkdownHTMLRendered Output
I just love **bold text**.I just love <strong>bold text</strong>.I just love bold text.
I just love __bold text__.I just love <strong>bold text</strong>.I just love bold text.
Love**is**boldLove<strong>is</strong>boldLoveisbold

Lists

MarkdownMarkdown
1. First item
2. Second item
3. Third item
4. Fourth item
- First item
- Second item
- Third item
- Fourth item
- Indented item
- 123. Escape with \
> A blockquote would look great.
console.log() //this is a code block
`This is too a inline code block`
I love supporting the **[EFF](https://eff.org)**.
This is the *[Markdown Guide](https://www.markdownguide.org)*.
See the section on [`code`](#code).

-- this is best practice
[link]
(https://www.example.com/my%20great%20page)

Images

-- simple link
![The San Juan Mountains are beautiful!](/assets/images/san-juan-mountains.jpg "San Juan Mountains")

-- link to an image
[![An old rock in the desert](/assets/images/shiprock.jpg "Shiprock, New Mexico by Beau Rogers")](https://www.example.com)

HTML Best Practices

For security reasons, not all Markdown applications support HTML in Markdown documents. When in doubt, check your Markdown application's documentation. Some applications support only a subset of HTML tags.

Use blank lines to separate block-level HTML elements like <div>, <table>, <pre>, and <p> from the surrounding content. Try not to indent the tags with tabs or spaces — that can interfere with the formatting.

You can't use Markdown syntax inside block-level HTML tags. For example, <p>italic and **bold**</p> won't work.